home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / HENSA / MATHS / PLPLOT / PLPLOT.ZIP / sys / os2 / pmserv / read.me < prev   
Encoding:
Text File  |  1994-05-11  |  3.9 KB  |  110 lines
  1. READ.ME
  2.  
  3. This file discusses the installation and usage of the OS/2 PM driver
  4. for PLPLOT distributed by Physical Dynamics.  Note that although the
  5. PLPLOT package is free of charge, there is a small fee for this add on
  6. package which supports OS/2 Presentation Manager.  Please do not
  7. redistribute the OS/2 PM driver and associated fies when you give PLPLOT
  8. to your friends or coworkers.
  9.  
  10. Individuals wishing to purchase this OS/2 PM support should send a check
  11. in the amount of $15 to:
  12.     Physical Dynamics
  13.     P.O. Box 8556
  14.     Austin, Tx 78713
  15.  
  16. Institutions wishing to obtain a multiple use licenses for this software
  17. should send:
  18.     1st 100 users, $15 each.
  19.     2nd 100 users, $10 each.
  20.     all additional, $5 each.
  21.  
  22. The package can be provided by standard postal mail on the floppy of your
  23. specification, or can be sent over the internet in uuencoded form.  Just
  24. state your preference, and provide an internet e-mail address if appropriate.
  25.  
  26. PACKING LIST
  27.  
  28. The package consists of a zoo archive containing the following files:
  29.     read.me        This file.
  30.     os2pm.c        Main driver for OS/2.  Goes into plplot.lib.
  31.     pmdefs.h    Header file for os2pm.c.
  32.     pmserv.exe    Standalone utility for producing actual PM output.
  33.  
  34.  
  35. INSTALLATION OF THE OS/2 SUPPORT
  36.  
  37. Unpack the zoo via 
  38.     zoo x os2pmdst
  39. in some convenient directory.  Then copy the pmserv.exe file to somewhere
  40. in your path.  Next copy pmdefs.h to plplot\include and os2pm.c to
  41. plplot\drivers.
  42.  
  43. Finally, modify the PLPLOT makefile for OS/2 to indicate that you want to
  44. include the os2pm driver.  There is a macro near the top of the makefile
  45. which is named drivers, and which looks like this:
  46.  
  47. DRIVERS    = -DPS -DLJII -DPLMETA -DHP7470 -DIMP #-DOS2PM
  48.  
  49. Change it uto look like this:
  50.  
  51. DRIVERS    = -DPS -DLJII -DPLMETA -DHP7470 -DIMP -DOS2PM
  52.  
  53. Secondly, further down in the makefile there is a macro named OS2_OBJ
  54. which names the specific .o files which will be included in the library.
  55. Just add to that list a line of the form:
  56.  
  57.     os2pm.o \
  58.  
  59. There are comments in the makefile to help you do this.
  60.  
  61. Finally, build PLPLOT in the usual way.  This time it will compile the
  62. os2pm.c file, and put it in the library.  When you link your programs to
  63. this new library and execute them, an option for output to OS/2 PM will
  64. be provided.
  65.  
  66. USING OS/2 PM SUPPORT WITH PLPLOT
  67.  
  68. Before executing any program which uses PLPLOT, you first need to have
  69. pmserv running.  Just open an OS/2 window, and issue:
  70.  
  71.     [c:\] pmserv
  72.  
  73. This will cause a new window to appear on your screen, with the title
  74. "pmserv.exe"  This is the window where all PLPLOT generated graphics will
  75. appear.
  76.  
  77. Once you have pmserv running on your system, you may execute programs which
  78. use PLPLOT.  just select the OS/2 PM option and you will see output in the
  79. window managed by the pmserv.exe program.
  80.  
  81. OPERATION OF PMSERV.EXE
  82.  
  83. pmserv.exe is easy to work with.  You can maximize it or minimize it in the
  84. usual way (by clicking on the min/max-imize buttons).  You can move the window
  85. around, and resize it to fit your desktop.  If there are graphics in the 
  86. window when you do this, they will be preserved.
  87.  
  88. To advance the frame (get the next in a series of plots generated by your
  89. program), just click on the Advance menu item, or use Alt-A.
  90.  
  91. If you will be generating lots of plots, and you do not wish to have to advance
  92. each one at time, you can put pmserv.exe into auto-advance mode by choosing
  93. the Auto Advance menu item under the Controls menu.  Currently those are
  94. the only two functions you need to be concerned with.
  95.  
  96. POSSIBLE PROBLEMS
  97.  
  98. If your program crashes in certain ways while using the OS/2 PM driver,
  99. it may cause pmserv.exe to hang.  In this case, just terminate pmserv with
  100. Alt-F4, and restart it.
  101.  
  102. SUPPORT
  103.  
  104. If you have any problems or wich to communicate with Physical Dynamics
  105. for any reason, you may send postal mail to the address given above,
  106. or you may send email to:
  107.     furnish@fusion.ph.utexas.edu
  108.  
  109. Comments or suggestions are of course welcome.    
  110.